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■ "Arch Linux exposes the user to the system without hiding any 
details." [man 7 archlinux] 

■ https://www.archlinux.org 

■ 36 developers, 40 trusted users, 8 support staff 

■ ABS & AUR 

■ pacman/ aura 

■ Arch iso 

■ rolling release, systemd 

■ lightweight, high customizability, easy build system 
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Note: The following assumes you also configure, what you install! 

■ Choose supported hardware!!! 

■ Install Archlinux 

■ Install cpupower 

■ Install linux-rt 

■ Install tuna & rt-tests 

■ Install rts & uenv 

■ Install jack2 

■ Install awesome 

■ Boot into realtime kernel 
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■ # Add your user to the audio group 
gpasswd -a <username> audio 
# Fully log out and log back in again 
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# Find the devices (and sometimes their parent devices), 

# that you will use/ need for your audio setup 

# You can also use your audio card's IRQ for the next test 
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■ # Add your user to the audio group 
gpasswd -a <username> audio 
# Fully log out and log back in again 


■ # Have a look at your hardware interrupts 
cat /proc/interrupts 

# Find the devices (and sometimes their parent devices), 

# that you will use/ need for your audio setup 

# You can also use your audio card's IRQ for the next test 


I # clone the realtimeconfigquickscan and run it 

git clone https://github.com/raboof/realtimeconfigquickscan 
cd realtimeconfigquickscan 
./realtimeconfigquickscan 

# Try and meet all criteria 

# (except maybe the one for ’fs.inotify.max_user_watches’) 
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Listing li Add systemd.setenv=REALTIME=true to your kernel command line 

# syslinux: /boot/syslinux/syslinux.cfg 

[. •] 

LINUX ../vmlinuz-linux-rt 

APPEND root=/dev/<your-root-fs> systemd.setenv=REALTIME=true rw 

[. .] 

# grub: /boot/grub/grub.cfg (or set stuff using /etc/default/grub) 

[. .] 

linux /boot/vmlinuz-linux-rt root=/dev/<your-root-fs> systemd.setenv=REALTIME=true rw 

C. .] 
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Figure: Sample tuna display of IRQs and kthreads on linux 
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Figure: Sample tuna display of IRQs and kthreads on linux-rt 
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Figure: Example Oscilloscope output (being fed by cyclictest) 


Listing 2: Cyclictest feeding oscilloscope 

# Start cyclictest (package: rt-tests) and feed it to oscilloscope (package: tuna) 
cyclictest --smp -n -p99 -m -v | oscilloscope >/dev/null 

< S > < 1 ► <!► 1 -O Q,o 











About 


Arch Linux 
as a 

lightweight 

audio 

platform 

David 

Runge 


Archlinux 

■ systemd is a system and service manager for Linux operating systems. When run as first process on boot 

Installation 


Config 

(as PID 1), it acts as init system that brings up and maintains userspace services, (man 1 init) 

Tests 


Systemd 


Realtime 


Conditionals 


IRQ & 
kthread 
scheduling 


Awesome 



□ ► < g ► <!►<!► 1 -O 0,0 


About 


Arch Linux 
as a 

lightweight 

audio 

platform 

David 

Runge 


Archlinux 

Installation 
Config 
Tests 
Systemd 
Realtime 
Conditionals 
IRQ & 
kthread 
scheduling 

Awesome 


■ systemd is a system and service manager for Linux operating systems. When run as first process on boot 
(as PID 1), it acts as init system that brings up and maintains userspace services, (man 1 init) 

■ systemctl <start / stop/enable/disable> *. {service,target,timer} 
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■ systemd is a system and service manager for Linux operating systems. When run as first process on boot 
(as PID 1), it acts as init system that brings up and maintains userspace services, (man 1 init) 

■ systemctl <start/stop/enable/disable> *. {service,target,timer} 

■ /run/systemd/system/*, 

/usr/lib/systemd/{system,user}/*, 

/etc/systemd/{system,user}/* 
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■ systemd is a system and service manager for Linux operating systems. When run as first process on boot 
(as PID 1), it acts as init system that brings up and maintains userspace services, (man 1 init) 

■ systemctl <start/stop/enable/disable> *. {service,target,timer} 

■ /run/systemd/system/*, 

/usr/lib/systemd/{system,user}/*, 

/etc/systemd/{system,user}/* 

■ /etc/systemd/journald.conf, 

/etc/systemd/logind.conf, 

/ etc/sy ste m d / syste m. co n f, 

/ etc/systemd / user.conf 
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■ My - S e fviee Can't Got Rea l time! 

■ Let's ignore dbus as long as it is not kdbus 

■ "[...] When a process is in a egroup in the “epu" controller, and no RT budget is set for that egroup, 
then RT is not available to it. This is very unfortunate. I'd love to assign an RT budget by default from 
systmed, but this isn't really doable, since there's no sane RT budget one could assign a egroup given the 
current semantics of it (which require that all RT budgets of eg roups within another egroup must sum up 
to less than 1/1... ). 

THis is something that needs to be cleaned up in the kernel, and then we can expose this nicer in systemd. 
For now, my recommendation would be to disable the RT egroup stuff in the kernel, and thus forego the 
whole problem. [...]" -Lennart Poettering 
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■ Let's ignore dbus as long as it is not kdbus 

■ "[...] When a process is in a egroup in the “epu" controller, and no RT budget is set for that egroup, 
then RT is not available to it. This is very unfortunate. I'd love to assign an RT budget by default from 
systmed, but this isn't really doable, since there's no sane RT budget one could assign a egroup given the 
current semantics of it (which require that all RT budgets of eg roups within another egroup must sum up 
to less than 1/1... ). 

THis is something that needs to be cleaned up in the kernel, and then we can expose this nicer in systemd. 
For now, my recommendation would be to disable the RT egroup stuff in the kernel, and thus forego the 
whole problem. [...]" -Lennart Poettering 

■ "[... ] anyone who wants to control epu egroups will be required to also become responsible for 
distributing RT scheduling." -Tejun Heo 
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■ My - S e fviee Can't Got Rea l time! 

■ Let's ignore dbus as long as it is not kdbus 

■ "[...] When a process is in a egroup in the “epu" controller, and no RT budget is set for that egroup, 
then RT is not available to it. This is very unfortunate. I'd love to assign an RT budget by default from 
systmed, but this isn't really doable, since there's no sane RT budget one could assign a egroup given the 
current semantics of it (which require that all RT budgets of eg roups within another egroup must sum up 
to less than 1/1... ). 

THis is something that needs to be cleaned up in the kernel, and then we can expose this nicer in systemd. 
For now, my recommendation would be to disable the RT egroup stuff in the kernel, and thus forego the 
whole problem. [...]" -Lennart Poettering 

■ "[... ] anyone who wants to control epu egroups will be required to also become responsible for 
distributing RT scheduling." -Tejun Heo 

■ ControlGroup, ControlGroupAttribute directives removed in systemd > 205 
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man 5 systemd.exec 


lOSchedulingClass = Sets the 10 scheduling class for executed processes. Takes an integer between 0 and 3 or 
one of the strings none, realtime, best-effort or idle. See ioprio_set(2) for details. 

lOSchedulingPriority = Sets the 10 scheduling priority for executed processes. Takes an integer between 0 
(highest priority) and 7 (lowest priority). The available priorities depend on the selected 10 scheduling class (see 
above). See ioprio_set(2) for details. 

CPUSchedulingPolicy = Sets the CPU scheduling policy for executed processes. Takes one of other, batch, idle, 
fifo or rr. See sched_setscheduler(2) for details. 

CPUSchedulingPriority = Sets the CPU scheduling priority for executed processes. The available priority range 
depends on the selected CPU scheduling policy (see above). For real-time scheduling policies an integer between 
1 (lowest priority) and 99 (highest priority) can be used. See sched_setscheduler(2) for details. 

CPUSchedulingResetOnFork = Takes a boolean argument. If true, elevated CPU scheduling priorities and 
policies will be reset when the executed processes fork, and can hence not leak into child processes. See 
sched s etscheduler (2) fordetails. De fa ultsto false. 

CPUAffinity = Controls the CPU affinity of the executed processes. Takes a space-separated list of CPU indices. 
This option may be specified more than once in which case the specified CPU affinity masks are merged. If the 
empty string is assigned, the mask is reset, all assignments prior to this will have no effect. See 
sched_setaffinity(2) for details. 


LimitCPU=, LimitFSIZE=, LimitDATA=, LimitSTACK=, LimitCORE=, LimitRSS=, LimitNOFILE=, 
LimitAS=, Limitl\IPROC=, LimitMEMLOCK=, LimitLOCKS=, LimitSIGPENDING=, LimitMSGQUEUE=, 
LimitNICE=, LimitRTPRIO=, LimitRTTIME= These settings set both soft and hard limits of various resources 
for executed processes. See setrlimit(2) for details. Use the string infinity to configure no limit on a specific 
resource. 
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# Sample configuration file for a JACK systemd --user servio 
NAME="default" 

DRIVER="firewire" 

DEVICE="/dev/fwl" 

N0ML0CK="" 

REALTIME="-R" 

PORTMAX =512 
UNL0CK="-u" 

VERB0SE="-v" 

DRIVER_SETTINGS = "\ 

-n 3 \ 

-p 256\ 

-r 48000" 


Conditionals 


IRQ & 
kthread 
scheduling 

Awesome 


Listing 4: /usr/lib/systemd/user/jack©.service 

[Unit] 

Description=JACK Audio 
After=sound.target local-fs.target 


[Service] 

EnvironmentFile=-/etc/conf. d/'/.i 
EnvironmentFile=-'/»h/. conf ig/ j ack/V.i 

ExecStart=/usr/bin/jackd -n $NAME $REALTIME -p $P0RTMAX -d SDRIVER -d 

CPUSchedulingPolicy=rr 

CPUSchedulingPriority=70 

LimitRTPRI0=71 

LimitRTTIME=-l 


e, using a firewire device 


$DRIVER_SETTINGS 
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WantedBy=default.target 


3 


>0 0.0 


Conditional cpupower (cpupower-rt) 


Arch Linux 
as a 

lightweight 

audio 

platform 

David 

Runge 


Archlinux 

Installation 
Config 
Tests 
Systemd 
Realtime 
Conditionals 
IRQ it 
kthread 
scheduling 


Listing 5: /usr/lib/systemd/system/cpupower-rt.service (package: uenv) 

[Unit] 

Description=Apply cpupower configuration 
ConditionKernelCommandLine=systemd.setenv=REALTIME=true 
After=cpupower.service 

[Service] 

Type=oneshot 

ExecStart=/usr/lib/systemd/scripts/cpupower-rt 
RemainAfterExit=yes 

[Install] 

WantedBy=multi-user.target 
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Listing 6: /etc/default/cpupower-rt 

# Define CPUs governor 

# valid governors: ondemand, performance, powersave, conservative, userspace. 
governor 5 ’performance’ 

# Limit frequency range 

# Valid suffixes: Hz, kHz (default), MHz, GHz, THz 
#min_freq="2.25GHz" 

#max_freq="3.4GHz" 


Tests 


Realtime 
Conditionals 
IRQ & 
kthread 
scheduling 


# Specific frequency to be set. 

# Requires userspace governor to be available. 

# Do not set governor field if you use this one. 

#freq= 

# Utilizes cores in one processor package/socket first before processes are 

# scheduled to other processor packages/sockets. 

# See man (1) CPUPOWER-SET for additional details. 

#mc_scheduler= 


# Utilizes thread siblings 

# scheduled to other cores 
#smp_scheduler= 


See man (1) CPUPOWER-SET for additional details. 


# Sets a register on supported Intel processore which allows software to convey 

# its policy for the relative importance of performance versus energy savings to 

# the processor. See man (1) CPUPOWER-SET for additional details, 
perf_bias =0 

# vim:set ts=2 sw=2 ft=sh et: 
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Listing 7: /usr/lib/systemd/user/compton.service 

[Unit] 

Description=Compton X Compositor 
After=display-manager.service local-fs.target 
ConditionFi1eIsExe cutable=/usr/bin/c ompt on 
ConditionKernelCommandLine=!systemd.setenv=REALTIME=true 

[Service] 

Type=f orking 

ExecStart=/usr/bin/compton —config °/,h/.config/compton.conf -l 
Restart=always 

[Install] 

WantedBy=default.target 
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Listing 8: /etc/rts/examples/w540-expresscard-firewire 

# IRQ scheduling 

Installation 

# set priority for hardware clock rtcO 
tuna -q 8 -p 90 

# set priority for device with irq 18 (firewire_ohci, i801_smbus) 

Config 

tuna -q 18 -p 85 

Tests 

# kthread scheduling 

Systemd 

tuna -t ’irq/*rtcO*’ -p 90 

Realtime 

tuna -t ’ irq/*i801_smb*’ -p 88 
tuna -t ’ irq/*firewire *’ -p 86 

Conditionals 


IRQ & 
kthread 
scheduling 

Listing 9: /usr/lib/systemd/system/rts@.service 

[Unit] 

Description=Apply Realtime-Kernel specific settings 

After=multi-user.target sound.target 

ConditionKernelCommandLine=systemd.setenv=REALTIME=true 

ConditionFilelsExecutable = / usr/bin/tuna 

[Service] 

Type=oneshot 

ExecStart =/usr/lib / systemd / scripts / rts '/, i 

RemainAfterExit=true 

[ Install] 

WantedBy=multi-user.target 
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",awesome is a highly configurable, next generation 
framework window manager for X. It is very fast, 
extensible and licensed under the GNU GPLv2 license." 

Using LUA, versatile and complex setups are possible 
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■ " awesome is a highly configurable, next generation 
framework window manager for X. It is very fast, 
extensible and licensed under the GNU GPLv2 license." 

■ Using LUA, versatile and complex setups are possible 

■ Being keyboard-based this might or might not be what 
you want 

■ Many themes available 

■ Auto-tiling! 
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■ ", awesome is a highly configurable, next generation 
framework window manager for X. It is very fast, 
extensible and licensed under the GNU GPLv2 license." 

■ Using LUA, versatile and complex setups are possible 

■ Being keyboard-based this might or might not be what 
you want 

■ Many themes available 

■ Auto-tiling! 

■ Integrates well with Desktop/Session Managers 
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Extensible via widgets 
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■ " awesome is a highly configurable, next generation 
framework window manager for X. It is very fast, 
extensible and licensed under the GNU GPLv2 license." 

■ Using LUA, versatile and complex setups are possible 

■ Being keyboard-based this might or might not be what 
you want 

■ Many themes available 

■ Auto-tiling! 

■ Integrates well with Desktop/Session Managers 

■ Extensible via widgets 

■ Well documented, vast wiki and a helpful community 
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■ " awesome is a highly configurable, next generation 
framework window manager for X. It is very fast, 
extensible and licensed under the GNU GPLv2 license." 

■ Using LUA, versatile and complex setups are possible 

■ Being keyboard-based this might or might not be what 
you want 

■ Many themes available 

■ Auto-tiling! 

■ Integrates well with Desktop/Session Managers 

■ Extensible via widgets 

■ Well documented, vast wiki and a helpful community 

■ Suited for work with lightweight and realtime 
environments 
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Questions, suggestions, blame? 

Mail: dave@sleepmap.de 

XMPP: dvzrv@sleepmap.de 

IRC: dvzrv@{efnet,freenode,oftc} 
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